|
WESCL
|

|
|
|
Wprowadzenie do języka WESCL
WESCL: Rev. 2.19
Pełna definicja
gramatyki i opis języka WESCL pt. "Get Going with WESCL" znajdują się
w kartotece "Dokumentacja języka WESCL" dyskietki firmowej NETICA. Zaznajomienie się z tym
dokumentem ułatwi Ci pracę i zaoszczędzi wiele czasu !
|
| |
|
| |
WESCL
- co to jest i jak działa |
|
WESCL
co to jest
|
WebEmbed Simple Control Logic (WESCL) jest prostym, aczkolwiek
bardzo silnym i elastycznym językiem programowania sterowników WebEmbed.
Dzięki niemu WebEmbed staje się programowalnym sterownikiem (PLC), który
potrafi autonomicznie monitorować i kontrolować lokalne urządzenia podłączone
do wejść/wyjść WebEmbed. Dodatkowo, WESCL zawiera unikalne mechanizmy
do komunikacji z siecią WEB i do wizualizacji. Pozwala to na zdalne
monitorowanie i zmianę stanu tych lokalnie podłączonych urządzeń z każdego
niemal komputera na świecie, jeśli wyposażony on jest w standardową
przeglądarkę HTML i dostęp do linii telefonicznej lub internetu.
WESCL jest jedną z możliwych aplikacji zaimplementowanych na
WebEmbed.
|
WESCL
jak to działa |
wescl jest jednym z procesów (task'ów) wielozadaniowego systemu czasu rzeczywistego w WebEmbed. Jego częściami składowymi są:
- kompilator języka WESCL: wczytuje on program
WESCL z pliku auto.scl (w kartotece home) do pamięci
programu, i tłumaczy go na kod wewnętrzny,
- egzekutor wescl: program pracujący w pętli
nieskończonej, wykonując program w kodzie wewnętrznym,
wygenerowanym przez kompilator z pliku auto.scl,
- cgi-bin wescl: program umożliwiający wymianę
danych między egzekutorem a przeglądarką HTML,
Kompilator WESCL wczytuje do pamięci i tłumaczy
(rekompiluje) program auto.scl
w następujących przypadkach:
- przy włączeniu zasilania,
- po zerowaniu (reset),
- po ustawieniu rejestru S0 na "1" przez program
sterujący auto.scl lub ze strony HTML użytkownika.
Egzekutor wescl w cyklu co 100ms (wartość standardowa, możliwa do
zwiększenia) wykonuje następującą sekwencję kroków:
- początek,
- wczytanie sygnałów wejściowych do zmiennych wejściowych,
- wykonanie instrukcji z programu auto.scl (wszystkie operacje
logiczne i arytmetyczne po kolei),
- zdekrementowanie wszystkich liczników (zmiennych Cx) o jeden,
- przepisanie stanu zmiennych wyjściowych do wyjść,
- koniec.
Cgi-bin wescl pozwala na komunikację między egzekutorem
wescl a przeglądarką komputera zdalnego w obu kierunkach:
Komunikacja przeglądarka HTML -> wescl:
zmienne WESCL mogą być zmieniane od strony browsera poprzez wywołanie
programu cgi-bin wescl wraz z odpowiednimi parametrami (wg
syntaktyki zgodnej z RFC 1738). Wywołania typu
wescl?zmienna=wartość&zmienna=wartość
mogą się znajdować zarówno jako hyperlinki w kodzie HTML, jak i w
linii URL przeglądarki. I tak dla przykładu wywołanie
http://<adres IP>wescl?O1=1
ustawia wyjście binarne WebEmbed na wartość logiczną "1".
Komunikacja wescl -> przeglądarka HTML:
Istotną częścią składową programu cgi-bin wescl jest tzw.
preprocesor
HTML. Generuje on z szablonu strony HTML (tzw. plik p-HTML) stronę
wynikową, która następnie zostanie wysłana z WebEmbed do przeglądarki.
Każda odpowiedź cgi-bin wescl jest "przepuszczana"
przez taki preprocesor. Stanowi on swoisty filtr: wszystkie łańcuchy znaków
typu &IOString(regname) zostają w stronie p-HTML
znalezione i zastąpione aktualnym stanem zmiennej WESCL regname,
przed odesłaniem jej do przeglądarki. Tak więc użytkownik, chcąc
przedstawić aktualny stan zmiennej WebEmbed na przeglądarce,
przygotowuje stronę HTML (a dokładniej: szablon takiej strony), gdzie w
miejscach prezentacji stanu zmiennych wpisuje zastrzeżony łańcuch &IOString(regname),
wstawiając w miejsce regname nazwę odpowiedniej zmiennej
(rejestru) WESCL, np. &IOString(M1) dla wyświetlenia aktualnej
wartości zmiennej M1, jak w przykładzie:
<br>M1=&IOString(M1) Stroną p-html jest plik HTML, którego
nazwa (link) jest aktualnie umieszczona w zmiennej V. Oczywiście
można zmieniać zawartość zmiennej V (w programie auto.scl
lub w wywołaniach cgi-bin wescl). Istnieje jednak tylko jedna
zmienna wizualizacji V, jako, że w danym momencie może być wysłana
tylko jedna strona HTML, jako odpowiedź cgi-bin wescl.
Użytkownik (projektant) tworząc własną aplikację przygotowuje następujące
pliki:
-
plik tekstowy auto.scl, stanowiący
program sterujący dla WebEmbed zgodnie z semantyką i syntaktyką języka
WESCL.
-
stronę/strony HTML (ewentualnie z
elementami Java, Javascript, itp.), stanowiącą/stanowiące de facto
szablon/szablony strony HTML dla preprocesora WebEmbed. Strona/strony
taka/takie zawierają zarówno hyperlinki do cgi-bin wescl
(tam, gdzie mają być zmieniane wartości zmiennych WESCL), jak i słowa
kluczowe &IOString(regname), stanowiące parametry formalne
dla cgi-bin wescl (tam, gdzie zmienne WESCL mają być
wizualizowane na przeglądarce).
- wszystkie ewentualne dodatkowe pliki graficzne, itp.
Wszystkie powyższe pliki zostają następnie załadowane do kartoteki home
WebEmbed przez FTP-upload. Po ponownej rekompilacji pliku auto.scl,
w przypadku braku błędów, WebEmbed autonomicznie wykonuje program
sterujący tam zapisany, niezależnie, czy jest połączony do sieci web,
czy też nie. Zewnętrzny użytkownik/obserwator może się
z nim łączyć w dowolnej chwili i oglądać/zmieniać stan zmiennych
systemowych (jeśli posiada uprawnienia typu użytkownik/hasło), przeglądając odpowiednie strony HTML i wywołując cgi-bin wescl. Uwaga:
-
nie myl pojęcia
WESCL, będącego definicją języka, w którym kodujesz programy
sterujące auto.scl, z wywołaniem cgi-bin wescl, które
umieszczasz jako hyperlink w Twojej stronie HTML lub wprowadzasz w
linii URL Twojej przeglądarki !
-
nie zapominaj o odpowiednim
ustawieniu/ustawianiu zmiennej wizualizacji V !
- nie zapominaj o rekompilacji
pliku auto.scl, po każdej jego zmianie !
Porada:
Podczas projektowania aplikacji możesz zechcieć na Twojej aktualnej
stronie roboczej umieścić hyperlink, powodujący rekompilację pliku auto.scl.
Może to wyglądać następująco:
<a HREF="wescl?V=Mypage.htm&S0=1">recompile
"auto.scl" and
start Mypage</a>
|
| |
WESCL
- elementy języka |
WESCL
Typy danych |
Język WESCL rozróżnia trzy typy danych:
- logiczne (boolean: true, false)
- całkowite 16-bitowe ze znakiem (signed integer: -32768 ..
32767)
- łańcuchy (string)
Konwersje typów są przeprowadzane wyłącznie między wartościami integer i
boolean:
- integer do boolean: wartość nierówna zero jest true,
a równa zeru jest false,
- boolean do integer: true równa się 1, false
równa się 0.
|
WESCL
Zmienne (rejestry) |
Język WESCL operuje na następujących zmiennych (rejestrach):
1.) zmienne/rejestry boolean:
2.) zmienne/rejestry numeryczne (16- bit signed integer):
- zmienne bez podtrzymania "volatile" (zerowane przy
każdym restarcie systemu) B0 .. B99
-
zmienne z podtrzymaniem (bateryjnym)
zawartości "non-volatile" (zachowują swoją zawartość
nawet po odłączeniu zasilania, nie zerowane przy restartach) M0 ..
M99. Przy starcie systemu WebEmbed rozpoznaje, czy podtrzymanie
bateryjne było cały czas obecne. Jeśli nie (słaba bateria lub
wymiana baterii) zmienne te są zerowane.
-
wejścia analogowo-cyfrowe D0 .. D19
(w WebEmbed-IND3: D1 .. D8)
-
liczniki cyklów wescl C0 .. C99
Pod koniec każdego cyklu egzekutora wescl wszystkie liczniki, których
wartość jest większa od 0, są automatycznie dekrementowane o 1.
-
specjalne rejestry kontrolne S0 .. S99
Rejestry kontrolne Sxx służą do monitorowania i
kontrolowania stanu systemu WebEmbed oraz niektórych jego opcji sprzętowych.
Rejestry te są dokładniej opisane w "Dokumentacji języka WESCL"
(rozdział 3).
Można je pogrupować według funkcjonalności:
S0 - identyfikuje i wymusza pierwszy
cykl egzekutora wescl (rekompilacja programu auto.scl)
S12, S13 - tylko w WebEmbed-IND3: obsługa binarnego wejścia
liczącego I12
S20 .. S28 - czas i data WebEmbed
S30 .. S33, S40 .. S57 - kontrola wysyłania poczty e-mail
(patrz opis agenta WCA)
S91 - mnożnik czasu cyklu egzekutora wescl.
Wykorzystywany dla wydłużania cyklu o wielokrotność 100ms, wg
formuły:
Czas cyklu wescl: S91 * 100ms
np. (w pliku HTML):
<a HREF="wescl?S91=3">prolong
wescl cycle by 3</a>
Wartość domyślna S91 wynosi 1.
Dzięki konwersji typów, zmienne
numeryczne mogą być również wykorzystywane jako zmienne typu boolean.
3.) zmienne/rejestry łańcuchowe (string variables):
Są to zmienne A0 .. A99, przechowujące łańcuchy znakowe ASCII i
wykorzystywane do sterowania wyglądem stron HTML na przeglądarce. Używa
się ich zwykle do deklarowania zmiennych elementów stron HTML,
przygotowując szablon takich stron dla preprocesora.
Zawartości zmiennych łańcuchowych w auto.scl muszą być deklarowane w
cudzysłowie,
np.
I1 and not O5 : A1 = "obrazek1.gif";
I1 and O5 : A1 = "obrazek2.gif";
Wykorzystanie powyższego zapisu w przygotowywanej przez projektanta
stronie HTML (pliku p-html) mogłoby, dla przykładu,
wyglądać następująco:
<img src="&IOString(A1)" width="350" height="285">
co spowodowałoby wyświetlenie w tym miejscu na przeglądarce
różnych obrazków, zależnie od stanu wyjść O5.
Sam znak cudzysłowu, jeśli ma być jednym ze znaków łańcucha, musi
być poprzedzony znakiem backslash'u, tzn. \". Można wówczas uzyskać
ten sam efekt z powyższego przykładu, inaczej umieszczając znaki cudzysłowu:
I1 and not O5 : A1 = "\"obrazek1.gif\"";
I1 and O5 : A1 = "\"obrazek2.gif\"";
a na stronie HTML wykorzystanie zmiennej A1 wyglądałoby:
<img src=&IOString(A1) width="350" height="285">
Opis pozostałych znaków
specjalnych znajdziesz w rozdziale 2.3.1 "Dokumentacji języka
WESCL".
4.) zmienna/rejestr
wizualizacji: V
Jest to (jedyna) zmienna zawierająca link do strony HTML (a dokładniej
do szablonu takiej strony, nazywanym umownie plikiem p-html), która ma być
przesłana do preprocesora HTML przed wysłaniem odpowiedzi do przeglądarki
przez cgi-bin wescl. Użytkownik sam ustawia jej zawartość w
pliku auto.scl lub na stronach HTML. Typowe jej wykorzystanie w
pliku HTML:
<a HREF="wescl?V=Anypage.htm">Goto Anypage</a>
Przy starcie programu, dopóki użytkownik samemu nie
zainicjalizuje zmiennej V, jej wartość domyślna wskazuje na plik
default.htm.
5.) zmienna/rejestr
stanu kompilatora i egzekutora wescl: E
Jest to preformatowana zmienna, informująca o statusie kompilatora
(ewentualne błędy kompilacji), jak i stanie procesu egzekutora wescl.
Więcej informacji na temat zmiennej E znajdziesz w rozdz. 4.2.2
"Dokumentacji języka WESCL".
|
WESCL
Instrukcje |
-
Instrukcje WESCL są
oddzielane średnikiem,
-
komentarze i tzw. znaki białe
(tabulator, nowa linia, spacja) są ignorowane,
-
komentarze w pojedynczej
linii rozpoczynają się podwójnym ukośnikiem '//', a wielowierszowe
muszą zawierać się między znakami '/*' a '*/' (podobnie jak w języku
C),
-
jedna instrukcja może
zajmować wiele wierszy; w jednym wierszu może być więcej niż
jedna instrukcja,
Instrukcje WESCL mają ogólną postać:
<expression> : <action>;
Zależnie od tego, co znajduje się po stronie <action>, instrukcje dzielą
się na dwa rodzaje:
-
w przypadku, gdy <action> zawiera operator przypisania
"=", instrukcja taka wykonywana jest wg reguły:
jeśli <expression> ma wartość true, to wykonaj
<action>
np.
I3 and I2 : O2=ON;
I1 : M5 = B9+M5;
-
w przypadku, gdy <action> nie zawiera operatora przypisania
"=", a więc tylko nazwę zmiennych, instrukcja taka
wykonywana jest wg reguły:
przepisz bezwarunkowo wartość <expression> do zmiennej
(zmiennych) stojących po stronie <action>
np.
B3-M1 : C9;
I3 : O5;
Dopuszczalne są również instrukcje z wielokrotnością operacji po
stronie <action>, rozdzielonych przecinkiem,
np.
jednorodne:
not C2: O1, O8, M1;
M1 : M2, M3, M4, M5;
M7 == -44 : O1=1, O2=0, B9=33;
lub mieszane:
M9 != 10 : M5=M3+1; B3, O2, C22=9;
!O1 : O1, B0=0;
Język WESCL dopuszcza również umieszczanie operacji w nawiasach,
podnosząc w ten sposób ich priorytet. Dopuszczalne jest zagnieżdżanie
w nawiasach do 5 poziomów.
np.
(M1 + M2) * 10 / (C3 - C4) : B20;
(I1 || I2) && B0 : M2 = ((M3 - B0) % 8) * B1;
|
WESCL
Operatory |
Język WESCL oprócz operatora przypisania definiuje następujące operatory:
operatory logiczne (wg malejącego priorytetu):
|
not
!
|
logiczna negacja |
|
and
&&
|
logiczny iloczyn |
|
or
||
|
logiczna suma |
operatory arytmetyczne (wg malejącego priorytetu):
|
-
|
negacja znaku |
|
*
|
mnożenie |
|
/
|
dzielenie |
|
%
|
dzielenie modulo |
|
+
|
dodawanie |
|
-
|
odejmowanie |
Operatory arytmetyczne mogą występować po obydwu stronach instrukcji: zarówno
po stronie <expression>, jak i <action> (jeśli jest to
przypisanie).
operatory porównania:
|
<
|
mniejszy niż
|
|
>
|
większy niż |
|
<=
|
mniejszy lub równy |
|
>=
|
większy lub równy |
|
!=
|
różny od |
|
==
|
równy |
Wszystkie operatory oraz ich bezwzględne priorytety są dokładniej opisane w rozdziale 2.6
"Dokumentacji języka
WESCL".
Niektóre operatory i słowa kluczowe języka WESCL mają swoje aliasy, (np. ':' i
'==>', 'true' i 'ON'), dokładniej opisane w rozdziale
2.9 "Dokumentacji języka WESCL".
|
WESCL
Przykłady |
Poniżej przedstawiono
kilka prostych przykładów użycia języka WESCL i jego elementów:
- w pliku auto.scl:
I1 and I2 or I3 : B1=-10, B2=M1+M2;
Do B1 jest wpisywana wartość -10, a do B2 suma aktualnych wartości
M1 i M2 pod warunkiem, że obydwa wejścia I1 i I2 lub wejście I3
jest w stanie true. W przeciwnym razie, zmienne B1 i B2
pozostają nie zmienione.
D1 > M20 ==> O1;
Jeśli D1 jest większe od M20, to wyjście O1 zostanie ustawione w
stan true ('ON'). W przeciwnym razie wyjście O1 będzie
w stanie false ('OFF').
S0 : C1=10;
C1 : O1;
Wyjście O1 jest ustawione w stan ON przez 1 sekundę od startu
systemu. Następnie wyjście to przechodzi w stan OFF.
not C90 and O5 : B1=0;
not C90 and not O5 : B1=1;
B1 : O5;
not C90 : C90 = 10;
Wyjście O5 zmienia cyklicznie stan: 1 sekunda ON / 1 sekunda OFF.
not S27 and !(S26%5) : O3;
Co pełne 5 minut ustaw wyjście O3 w stan ON na czas 1
sekundy.
- ustawianie zmiennej WESCL na stronie HTML:
<a HREF="wescl?C10=600"><img src="button.gif">Timer
to 1 Minute</a>
Kliknięcie na ikonkę pt. button.gif lub na link powoduje ustawienie
licznika C10 w WebEmbed na 1 minutę.
- wyświetlanie aktualnego stanu zmiennych WESCL na stronie HTML:
a) dla zmiennych boolean i integer (preprocesor
wstawia aktualną wartość zmiennej):
<br>D12 = &IOString(D12)
<br>The value of I3 is &IOString(I3)
Na przeglądarce widoczne będą nazwy obydwu zmiennych i ich aktualne
wartości.
b) dla zmiennych łańcuchowych (preprocesor
wpisuje do strony HTML cały aktualny łańcuch, będący zawartością
zmiennej):
<a HREF="wescl?O1=&IOString(A5)></a>
gdzie zmienna A5 została przygotowana w pliku auto.scl na
przykład w następujący sposób:
O1 : A5="OFF\">Output 1 is ON - Turn it OFF";
not O1 : A5="ON\">Output 1 is OFF - Turn it ON";
Powyższy przykład, choć wydaje się bardzo
skomplikowany, jest typowym przykładem wizualizacji dynamicznego
hyperlinka na stronie HTML, zależnego od stanu zmiennej, którą
steruje.
Zastosowanie zmiennych łańcuchowych do manipulacji plikami HTML daje
niemal nieograniczone możliwości.
Przykład zmiany koloru na stronie HTML, w zależności od stanu
zmiennej:
<font
color="&IOString(A1)">
przy czym zmienna A1 jest w pliku auto.scl np. zdefiniowana
jako:
M3<=10: A1 = "#0000FF";
M3>10 : A1 = "#FF0000";
|
| |
Wysyłanie
wiadomości e-mail
(WESCL Communication Agent WCA) |
WCA
możliwości |
WebEmbed pozwala na kontrolowane,
autonomiczne wysyłanie poczty elektronicznej e-mail.
W tym celu nawiązuje on kontakt z zadeklarowanym przez użytkownika
rzeczywistym serwerem poczty wychodzącej (tzw. serwerem SMTP), którego
adres IP użytkownik definiuje na stronie
konfiguracyjnej WebEmbed. Jeśli serwer SMTP dostarcza dodatkowo usługę
automatycznego przekazywania wiadomości elektronicznych na wiadomości SMS,
odbiorcy mogą być natychmiastowo powiadamiani o wystąpieniu
określonych zdarzeń w systemie kontrolowanym przez
WebEmbed.
Wysyłanie poczty email jest w pełni zintegrowane z
egzekutorem wescl,
co pozwala na:
a) pełną kontrolę zdarzeń warunkujących wysyłanie wiadomości e-mail
(w pliku auto.scl lub p-html),
b) pełną integrację zmiennych (rejestrów) WESCL w treści tych wiadomości
i ich załącznikach.
Wysyłanie poczty elektronicznej jest w dużym stopniu
sparametryzowane, pozwalając m. in. na:
-
elastyczną i zmienną listę odbiorców wiadomości,
-
różnorodny i dynamicznie wybieralny,
predefiniowalny tekst wiadomości,
-
opcjonalne dołączanie do wiadomości załącznika, zawierającego
rejestr stanów wybranych przez projektanta zmiennych (rejestrów)
WESCL w określonych momentach czasu,
-
formatowanie załącznika,
-
kontrolę poprawności wysłania wiadomości e-mail.
Szczegółowy opis agenta pocztowego WCA, wraz z charakterystyką
wszystkich jego parametrów znajduje się w "Dokumentacji języka
WESCL", rozdz. 5.
|
| Adresowanie
i komponowanie wiadomości |
1.) Adresowanie
Adresat, wraz z nadawcą i tematem wiadomości są zdefiniowani w pliku
address.#n (w kartotece home), gdzie #n jest liczbą od 1 do
32768. Oznacza to, że WebEmbed pozwala na zdefiniowanie do 32768 zestawów
adresatów (w plikach address.1 ... address.32768).
Każdy z plików address.#n może składać się tylko z jednej
linii (o maks. długości 512 znaków). W linii tej powinny wystąpić wymagane pola adresacji wiadomości
e-mail (fraza mailto:), jednoznacznie zdefiniowane w RFC 2368. Są to:
- from= (obowiązkowe)
- to=
- cc=
- bcc=
- Reply-To=
- In-Reply-To=
- subject=
Przykład zawartości pliku address.#n:
mailto: Piotr Iksinski <Iksinski@friko3.onet.pl>,
<netica@pro.onet.pl>?from=<webembed@interia.pl>
&cc=<webembed@wp.pl>&Reply-To=
<netica@pro.onet.pl>&subject=Exception happened !!
2.) Treść wiadomości Treść wiadomości jest
plikiem tekstowym (ASCII) i znajduje się w jednym z plików body.#n (w kartotece home), gdzie #n jest liczbą od 1 do
32768. Oznacza to, że WebEmbed pozwala na zdefiniowanie do 32768 różnych
wiadomości (w plikach body.1 ... body.32768). Treść
wiadomości może zawierać łańcuchy &IOString(regname), które
przed wysłaniem do odbiorcy są zastępowane aktualnymi wartościami
zmiennych (rejestrów) WESCL, podobnie jak to ma miejsce w przypadku
strony p-html przed przesłaniem jej do przeglądarki. Przykład
zawartości pliku body.#n: Both
inputs I1 and I2 are true. Today's date is: day:
&IOString(23) month:
&IOString(22) year:
&IOString(20) 3.) Załącznik Jako
załącznik wiadomości e-mail może być dołączona część lub całość
tzw. bufora cyklicznego. Bufor cykliczny zapamiętuje do 512 rekordów, po
osiem wybranych zmiennych (rejestrów) WESCL każdy. Opcjonalnie, każdy
rekord może być poprzedzony datą i godziną jego rejestracji (tzw. timestamp). Użytkownik
ma możliwość wyboru zmiennych zapisywanych w buforze, kontroli stanu zapełnienia bufora, ilości rekordów umieszczanych w załączniku
oraz formatowania tegoż załącznika. W każdym rekordzie zapisywane
jest 8 zmiennych WESCL, w kolejności S50 ... S57. Zapisywaniem do
bufora steruje rejestr S40. Użytkownik przed zapisaniem rekordu do
bufora powinien (w pliku auto.scl lub z przeglądarki) zdefiniować
jego aktualną zawartość, przypisując zmiennym S50 ... S57 albo
konkretną wartość absolutną, albo (częściej) aktualne wartości
innych zmiennych WESCL. Nie trzeba przy tym wykorzystywać wszystkich ośmiu
zmiennych: ich ilość w rekordach, pojawiających się w e-mailu, jest
określona w pliku formatującym attachment.#n (w kartotece home),
chociaż w buforze cyklicznym faktycznie zawsze zapisywane jest wszystkich
8 zmiennych. WebEmbed wysyła jako załącznik e-mail tylko tyle zmiennych
rekordu, ile użytkownik zdefiniował w pliku formatującym. Formatowanie
załącznika w plikach formatujących attachment.#n (#n = 1 ..
32768) polega na zadeklarowaniu ilości i formatu zmiennych, wspólnego
dla każdego rekordu w buforze. Obowiązują przy tym formaty: %d, %u,
%x, %X, zdefiniowane podobnie, jak w języku C. Timestamp
każdego rekordu (%t), jeśli pożądany, musi występować na
pierwszej pozycji formatowania. Przykład formatowania rekordu z bufora,
przesłanego jako załącznik do wiadomości email (zawartość pliku attachment.#n): First:
%04d ; Second: %3d ; Third: %2d Oznacza to, że w załączniku
wiadomości e-mail będą zamieszczone rekordy z bufora cyklicznego, z których
każdy będzie rejestracją stanów trzech zmiennych: S50, S51,
S52. Stany tych zmiennych wynikają z ich aktualnego przyporządkowania
innym zmiennym WESCL (lub wartościom absolutnym), zazwyczaj wg programu auto.scl.
Ilość rekordów bufora wysyłanych wraz z wiadomością e-mail określa
zmienna S33. Załącznik wiadomości sformatowany wg powyższego
przykładu będzie mógł u odbiorcy wyglądać np. w sposób następujący
(przy założeniu, że S33=3): First:
0012 ; Second: 764 ; Third: 21
First: 0008 ; Second: 5 ; Third: 1
First: 7712 ; Second: 11 ; Third: 82
|
| Wysyłanie
poczty |
Wysyłaniem i kontrolą poprawności wysyłania
wiadomości e-mail rządzi zestaw zmiennych (rejestrów) WESCL. Najważniejsze
z nich to:
| S30 |
wybór pliku address.#n (S30=5
wskazuje na address.5) |
| S31 |
wybór pliku body.#n (S31=1
wskazuje na body.1). Wartość 0 oznacza brak treści
(body). |
| S32 |
wybór pliku attachment.#n (S32=22
wskazuje na attachment.22). Wartość 0 oznacza brak załącznika. |
| S33 |
ilość rekordów z bufora, która ma być załączona
w wiadomości. Wartość 0 powoduje wysłanie całego aktualnego
bufora. Rekordy wysłane zostają wykasowane z bufora. |
|
|
| S40 |
zapis rekordu do bufora cyklicznego |
| S41 |
kasowanie całości bufora |
| S42 |
wysyłanie wiadomości |
| S43 |
przerwanie wysyłania wiadomości |
| S44 |
wskaźnik zakończenia wysyłania wiadomości |
| S45 |
kod błędu wysyłania (major) |
| S46 |
aktualna ilość rekordów w buforze |
| S47 |
pojemność bufora cyklicznego (w rekordach) |
| S48 |
wskaźnik przepełnienia bufora |
| S49 |
kod błędu wysyłania (minor) |
Pełny wykaz i opis wszystkich rejestrów (zmiennych) WCA oraz możliwe
kody błędów znajdziesz w "Dokumentacji języka WESCL", w
rozdz. 5.
Przykłady sterowania procesem wysyłania wiadomości e-mail w
programie auto.scl:
-
zapisywanie rekordu do
bufora:
true: S50=B1, S51=M1, S52=D1, S53=-99, S40=1;
-
zerowanie bufora:
true: S41 = 1;
-
wysłanie wiadomości wg
wybranych plików adresacji, treści i formatowania (kompletny bufor):
!S44 ==> S30=1, S31=1, S32=1, S33=0;
S42=1;
-
sprawdzenie poprawności
wysłania wiadomości (z przygotowaniem tekstu dla strony HTML):
!S44 && !S45 && !S49 :
A1="message sent";
Więcej przykładów znajdziesz zarówno w "Dokumentacji języka
WESCL", rozdz. 5, jak i w kartotece SMTP-test na
dyskietce firmowej.
|
| Wskazówki |
Kilka pożytecznych rad na zakończenie:
-
aby WebEmbed potrafił wysyłać
wiadomości e-mail, łącząc się bezpośrednio z internetem (poprzez
modem), adres IP jego domyślnej bramy
(Gateway) musi być 0.0.0.0,
-
aby znaleźć adres IP
konkretnego (znanego Ci) serwera SMTP, wykorzystaj na Twoim komputerze
komendę 'PING' z podaniem nazwy tego serwera, po uprzednim połączeniu
się z internetem,
-
serwery SMTP, chociaż nie
wymagają autoryzacji (użytkownik/hasło), często mają inne
ograniczenia (różne dla różnych serwerów). Np. niektóre przyjmują
pocztę do wysłania tylko od zarejestrowanych (znanych im)
użytkownikom (analizują pole from= frazy mailto:)
|
| powrót
do początku strony |
HOME
|